home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Prog / M / May MacUser Program.cpt / Readme < prev   
Encoding:
Text File  |  1990-03-29  |  3.8 KB  |  95 lines  |  [TEXT/KAHL]
  1.     Read this file before trying to compile miniGenericApp.
  2.     
  3.     
  4.     Just when you thought it was easy to program in THINK C -- not 
  5.     all THINK C's are created equally. As a matter of fact, they're
  6.     all different in subtle ways. Read On.
  7.     
  8.     Version 4.0 of THINK C supports the so-called "ANSI" standard
  9.     definition of the C language. Previous versions of the 
  10.     Compiler don't. Therefore, header files and libraries that 
  11.     existed in earlier versions of Lightspeed don't exist anymore. 
  12.     The obvious advantage to this is that it's easier to write 
  13.     portable code, i.e., code that will compile and run on non-
  14.     THINK C compilers that also support ANSI.The major disadvantage 
  15.     is that you need to make slight changes to source of Generic App
  16.     depending on whether you're using Version 2, 3, or 4 of the 
  17.     compiler.
  18.  
  19.  
  20.     Thus header file names changed between versions. Also, beginning with
  21.     version 3.0, a slick, new feature called MacHeaders was introduced.
  22.     When the MacHeaders option is selected, the compiler uses a binary file
  23.     that describes all about Mac related data types, meaning that you
  24.     don't have to include those manager header files that define fundamental 
  25.     Mac data structures like Event Records, WindowRecords, and the lot.
  26.     
  27.     Also between version 2 and 3, Multifinder became functional.So version
  28.     3 supports Multifinder while version 2 doesn't. There really are a lot of 
  29.     changes between the three versions.
  30.     
  31.     Because I want you folks out there to have running versions 
  32.     of Generic App, no matter what version of the compiler that 
  33.     you happen to own, I've devised a strategy that should allow everyone
  34.     to use Generic (for the time being--I want you all to upgrade if you're going
  35.     to continue with us and use the code examples. These three parts of Generic
  36.     will be the only code that's written with this accomodation. (BTW, Symantec
  37.     isn't paying me a commission for my one-man upgrade promotion but,
  38.     perhaps they ought to offer a discount to my MacUser readers!)
  39.     
  40.     Here's how you get Generic to work on your compiler:
  41.     
  42.     First: Find out what version of THINK C that you're running.
  43.     
  44.     Next, there are three project files, one for version 2, 3, and 4 of
  45.     THINK C. You use the one that's appropriate for your compiler. Then,
  46.     we'll let the preprocessor to fixup the code for you through the
  47.     use of a defined constant. This constant is in the file "Version.h" so
  48.     open that file right now. It's in the miniGenAppHdr folder, with all
  49.     the other header files.
  50.     
  51.     Step-by-step, here's what you do:
  52.     
  53.         For those of you who are running THINK C version 4.0:
  54.         
  55.             0. Open project file miniGenAppπ-v4.0
  56.             1. change #undef V4 to #define V4 in Version.h.
  57.             2. make sure that you undefine V3 and V2.
  58.             3. Rename the resource file miniGenAppπ.rsrc
  59.                 to miniGenAppπ-v4.0.rsrc
  60.             4. Bring the Project "Up to Date"
  61.                 
  62.         For those of you running version THINK C 3.01:
  63.         
  64.             0. Open project file miniGenAppπ-v3.01
  65.             1. change #undef V3 to #define V3 in Version.h
  66.             2. make sure that you undefine V2 and V4.
  67.             3. Rename the resource file miniGenAppπ.rsrc
  68.                 to miniGenAppπ-v3.01.rsrc
  69.             4. Bring the Project "Up to Date"
  70.  
  71.         For those of you running versions Lightspeed 2.13 or 2.15:
  72.         
  73.             0. Open project file miniGenAppπ-v2.13
  74.             1. change #undef V2 to #define V2 in Version.h
  75.             2. make sure that you undefine V3 and V4.
  76.             3. Rename the resource file miniGenAppπ.rsrc
  77.                 to miniGenAppπ-v2.13.rsrc
  78.             4. Run the project
  79.             
  80.         For those of you running anything else:
  81.         
  82.             1. Isn't it time that you catch up with the rest of us?
  83.                 
  84.                 
  85.         After we finish Generic App, all examples will
  86.         be in THINK 4.0, period. There are a few
  87.         good reasons for this, and you'll discover them
  88.         as we get there. So please, anyone who is not
  89.         using the latest version of the compiler,
  90.         may we suggest that you THINK about upgrading?
  91.                 
  92.  
  93.         All the best,
  94.         
  95.         kwgm